home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 1 / CU Amiga Magazine CD-ROM Special Edition (1995)(EMAP Images)(GB)[Issue 1995-11].iso / Tools / Docs / DeliTrk < prev    next >
Text File  |  1994-10-13  |  36KB  |  876 lines

  1. IMPORTANT NOTICE: This is only part of the documentation for DeliTracker.
  2. The complete docs you find in the distribution archives in the mus/play
  3. directory. Also note that the installed version of DeliTracker is V1.3
  4. (since it runs under OS 1.3), but newer versions exist on this CD and can
  5. be installed on harddisk and activated in the 'Prefs' program.
  6.  
  7. ==========================================================================
  8.  
  9. ***************************************************************************
  10. *                               DeliTracker                  *
  11. ***************************************************************************
  12.  
  13.                             © 1992 by Delirium
  14.                          $VER: V1.30 (22.09.1992)
  15.  
  16.  
  17.  
  18. 1. CONTENTS
  19.  
  20.         1.CONTENTS
  21.  
  22.         2.LICENSING AND DISTRIBUTION
  23.  
  24.         3.INTRODUCTION
  25.           3.1 What is DeliTracker ?
  26.           3.2 Why use DeliTracker ?
  27.  
  28.         4. GETTING STARTED
  29.           4.1 System requirements
  30.           4.2 Starting from CLI/Shell
  31.           4.3 Starting from Workbench
  32.           4.4 Installation
  33.  
  34.         5. BASICS
  35.           5.1 Player 
  36.           5.2 Packed modules
  37.           5.3 Kickstart 2.0 
  38.           5.4 Options
  39.           5.5 Configuration files
  40.  
  41.         6. HOW TO CONTROL DELITRACKER
  42.           6.1 The main window
  43.             6.1.1 Gadgets 
  44.             6.1.2 Menus
  45.             6.1.3 Shortcuts 
  46.           6.2 The preferences window
  47.             6.2.1 Gadgets 
  48.             6.2.2 Shortcuts 
  49.           6.3 ARexx 
  50.  
  51.         7. TROUBLESHOOTING
  52.  
  53.         8. THE FUTURE OF DELITRACKER
  54.  
  55.         9. ACKNOWLEDGEMENTS
  56.  
  57.  
  58.  
  59. 2. LICENSING AND DISTRIBUTION
  60.  
  61.           DeliTracker (c) 1992 by Peter Kunath and Frank Riffel.
  62.  
  63.   This Program is Shareware. If you like this program and use it
  64.   frequently, we encourage you to register. The shareware fee is $US 20
  65.   or 20 DM. You may send CASH or EUROCHEQUE's. We cannot accept any other
  66.   cheques cause it is not possible for us to cash foreign checks without
  67.   having to pay substantial fees to the bank. Registered users will be
  68.   shipped a disk with the latest release version of DeliTracker. By
  69.   cooperating with this concept you help to ensure continued development
  70.   of this product. Please send your registration card (Orderform) and
  71.   the money to:
  72.  
  73.                                Frank Riffel
  74.                                 Merkstr. 27
  75.                               8129 Wessobrunn
  76.                                   Germany
  77.  
  78.  
  79.   You may send bug reports, remarks, and suggestions to this address as
  80.   well. If you have written a new soundsystem and you wish to adapt your
  81.   replay-routine to DeliTracker, contact us. We will help you.
  82.  
  83.   DeliTracker may be distributed on public-domain, shareware disks, and
  84.   electronic networks such as the Internet as longs as the followings
  85.   conditions are fulfilled:
  86.  
  87.     ° all files must be kept together. You can find a list of all
  88.       files in 'Distribution'.
  89.  
  90.     ° no part of the distribution may be changed in any way. The only 
  91.       exception is archiving (e.g. with LhA), but the original files 
  92.       must be 100% restoreable.
  93.  
  94.     ° The price of a disk that contains DeliTracker must be less than 
  95.       US $6 or 8.- DM. The same is the maximum price that networks 
  96.       may charge from their users for downloading DeliTracker.
  97.  
  98.     ° For use in commercial products the permission of the authors
  99.       is required.
  100.  
  101.   DeliTracker was developed and tested very carefully. Nevertheless
  102.   the Authors are not responsible for any damages that are caused by
  103.   DeliTracker. Use at your own risk.
  104.  
  105.  
  106. 3.INTRODUCTION
  107.  
  108.   3.1 What is DeliTracker ?
  109.  
  110.   DeliTracker is a soundplayer which supports several soundformats; some
  111.   are SoundTracker 15 inst., SoundTracker 31 inst., NoiseTracker,
  112.   ProTracker, StarTrekker without AM sounds and CustomPlay. Since these
  113.   types are so common, their replay routines are built within DeliTracker
  114.   itself. Additional players are loaded from disk, meaning that you can
  115.   very easily add/update players by placing them into the DeliPlayers
  116.   directory. DeliTracker is NOT a Songeditor, MIDIsequencer or Digitizer.
  117.   It is only meant to play music modules in a comfortable way.
  118.  
  119.   3.2 Why use DeliTracker ?
  120.  
  121.   There are many reasons for using DeliTracker; here is only a small list:
  122.  
  123.         ° system friendly and multitasks happily
  124.         ° allocates the soundchannels
  125.         ° correct playspeed in PAL/NTSC (uses timerinterrupts)
  126.         ° works well with serial.device
  127.         ° supports xpkmaster.library for decrunching
  128.         ° supports up to 64 players
  129.         ° runs fine with 680x0 and Kick2.0
  130.         ° ARexx support
  131.         ° has a configfile
  132.         ° enforcer and mungwall proof
  133.         ° supports full CLI or Workbench (ToolTypes) environment
  134.         ° easy to use & looks good
  135.         ° has Volume/Balance sliders
  136.         ° resident cli startup
  137.         ° supports multiselect
  138.         ° written in 100% Assembler
  139.  
  140.  
  141. 4. GETTING STARTED
  142.  
  143.   4.1 System requirements
  144.  
  145.   DeliTracker doesn't need extensive hardware or software. An Amiga with
  146.   Kickstart 1.2 or higher, 100KB free memory (plus memory for the module)
  147.   and the 'req.library' are only required. If you want to use packed
  148.   modules, the 'xpkmaster.library' and the corresponding sublibraries must
  149.   be installed. Make sure that you use V2 of XPK! V1 is NOT sufficient.
  150.   For DeliTracker_2.x, Kickstart and Workbench 2.04 are required. Of course
  151.   your System should be equiped with a Monitor that has speakers or even
  152.   better with a HiFi system.
  153.  
  154.  
  155.   4.2 Starting from CLI/Shell
  156.  
  157.   Open a Shell or CLI window and CD to the directory where DeliTracker is
  158.   located. Now you can type 'DeliTracker' followed by none/one/more options
  159.   explained in 5.4. The options and arguments should be separated by spaces. 
  160.   DeliTracker automatically detatches from the CLI and you may close the 
  161.   CLI window. If a wrong arument is supplied DeliTracker quits with a short
  162.   helptext.
  163.  
  164.   Example: 'DeliTracker config DT.config volume 32 filter 0'
  165.   
  166.   Starts DeliTracker with 'DT.config' as configuration file, turns the
  167.   lowpass filter off (not on A1000's) and sets the volume to 32.
  168.  
  169.  
  170.   4.3 Starting from Workbench
  171.  
  172.   Open the drawer that contains DeliTracker and start it with a double
  173.   click. All options can be set as ToolTypes by using the 'Info' item
  174.   from the Workbench. The options must be separated by an '=' from the
  175.   arguments. Invalid Tooltypes are ignored. DeliTracker can be used as
  176.   a 'Default Tool' for automatic playing of modules.
  177.  
  178.   Example:      Config=DT.config
  179.                 PrefWinXY=0/11
  180.                 Volume=43
  181.                 Window=NO               ; CX_Popup=NO for 2.x version
  182.  
  183.   If DeliTracker is started with these tooltypes, it loads 'DT.config' as
  184.   the configuration file and sets the volume to 43. The main window is not
  185.   opened in case arexx is running. This assures that the user can quit
  186.   DeliTracker. The next time the preferences window is opened at 0/11.
  187.  
  188.   4.4 Installation
  189.  
  190.   If you already use an older version of DeliTracker, please delete all
  191.   files of the old distribution and your configuration files before you
  192.   install this version.
  193.  
  194.   Copy the version for your kickstart in a directory of your choosing.
  195.   Now copy the whole 'DeliPlayers' directory into this place. We strongly
  196.   suggest that you move never or seldom used players from DeliPlayers/ to
  197.   DeliPlayers/PlayerStore/. If you don't do this you waste memory! When 
  198.   DeliTracker is started every player in the 'DeliPlayers' drawer will 
  199.   be loaded. Note: any loaded player will stay in memory until the user
  200.   unloads it or DeliTracker is exited. DeliTracker need req.library to
  201.   run. If you don't have req.library in LIBS:, double click on the CopyLibs
  202.   icon. The script will install V2.5 of req.library in LIBS:.
  203.  
  204.  
  205. 5. BASICS
  206.  
  207.   5.1 Player 
  208.  
  209.   With DeliTracker it is possible to load single players. This has the
  210.   advantage that you may only load the players that you need (= efficient
  211.   memoryusage). Of course, you may unload any player at any time. Another
  212.   drawback is that you only need to know the 'DeliTracker-player' rather
  213.   than every single player. Multimedia applications in conjunction with
  214.   ARexx greatly benefit from this (e.g. You may play any Module in an 
  215.   AmigaVision(TM) presentation). Another major advantage is that the player
  216.   interface is very flexible so everyone may easily enhance/update/adapt
  217.   or write players. DeliTracker has the most common players built in. These
  218.   are: StarTrekker without AM sounds, SoundTracker15, SoundTracker31,
  219.   NosieTracker and Protracker. There is another player called 'CustomPlay';
  220.   this is a special player that was created to play special modules that
  221.   contain their own player. These 'modules' may NOT be crunched, because
  222.   they are loaded via LoadSeg() to allow relocation. All external players
  223.   are listed in the 'Players.doc'. For details on programming players read
  224.   the includefile and 'Programming.doc'.
  225.  
  226.   5.2 Packed modules
  227.  
  228.   If xpkmaster.library V2 or higher is installed DeliTracker will use the
  229.   library for decrunching. Certain players do NOT support module packing!
  230.   This is due to the fact that those players load the module by themselves
  231.   rather than using the internal LoadFile() function. If the player-info
  232.   field for a particular player shows 'Packable....NO' you are not allowed
  233.   to crunch modules of this player. NOTE: Don't pack custommodules because
  234.   they are loaded and RELOCATED via LoadSeg()!
  235.  
  236.  
  237.   5.3 Kickstart 2.0 
  238.  
  239.   To use some of the features provided by Kickstart 2.0 we have decided to
  240.   build a special version. The current version does not use all features
  241.   of V37, but all 2.0 specific handling is done right. DeliTracker_2.x has
  242.   the following advantages/differences to the Kick 1.3 Version:
  243.  
  244.         ° Menulayout done with gadtools.library
  245.         ° Colors changed to match the 2.0 palette.
  246.         ° The mainwindow has a Zip-Gadget
  247.         ° Modules can be played by simply dropping the moduleicon into
  248.           the mainwindow (Appwindow).
  249.         ° complete PubScreen support
  250.         ° usage of Systemrequesters
  251.         ° hotkey for MainWindow opening/closing; some things may be
  252.           controlled with the Commodities Exchange Program
  253.  
  254.  
  255.   5.4 Options
  256.   
  257.   To allow an easy and flexible configuration, DeliTracker uses the
  258.   following options. These options are used as KEYWORDS in Tooltypes,
  259.   Configurationfiles and CLI templates. The options are not case sensitive!
  260.  
  261.   Option                  Default value and description 
  262.   --------------------    -----------------------------
  263.  
  264.   cx_priority <pri>       0 (default priority)
  265.                           Sets the commodities priority. Valid values
  266.                           are -128 to 127. This option is only found 
  267.                           in the 2.x version of DeliTracker.
  268.  
  269.   cx_popup <yes|no> (2.x) yes (window opened)
  270.   or                      Defines if the control window should be opened
  271.   window <yes|no> (1.3)   at startup. If it is set to 'no', the main window
  272.                           will not be opened. It may be opened via hotkey,
  273.                           Commodities Exchange (2.x) or with an ARexx 
  274.                           command. The Kick 1.3 version only supresses the
  275.                           opening of the mainwindow if the AREXX-Server is
  276.                           running.
  277.  
  278.   cx_popkey <string>      "" (no hotkey)
  279.                           This defines the hotkey that is used to open or
  280.                           close the main window. If the mainwindow is 
  281.                           closed via hotkey the prefs window is closed as
  282.                           well -- the same applies to Hide Interface. To 
  283.                           disable the hotkey use the INACTIVE option of
  284.                           the Commodities Exchange Program. This function
  285.                           is only accessible in the 2.x version.
  286.  
  287.   config <file>           "ENV:DeliTracker.config"
  288.                           Loads the specified file as a configuration file.
  289.                           Note: This option may not be specified in a
  290.                           configuration file!
  291.  
  292.   module <file>           No file, empty module list.
  293.                           Adds the <file> to the module list.
  294.  
  295.   pubscreen <Screen>      "", default PubScreen (usually Workbench).
  296.                           Let you specify the name of the public screen
  297.                           where DeliTracker should pop up. If the given
  298.                           screen is not available (e.g. does not exist),
  299.                           DeliTracker opens its windows on the default
  300.                           public screen. This function is not implemented
  301.                           in the Kick 1.3 version.
  302.                           Note: Screen names are case sensitive!
  303.  
  304.   playerpath <path>       "DeliPlayers"
  305.                           Sets the path where DeliTracker loads the 
  306.                           external players.
  307.  
  308.   windowxy<XPos>/<YPos>   0/0
  309.                           Attempts to open the mainwindow at the given 
  310.                           position. If this fails the window will be opened
  311.                           at 0/0.
  312.  
  313.   prefwinxy<XPos>/<YPos>  0/1
  314.                           Attempts to open the prefs window at the given
  315.                           position. If this fails the window will be opened
  316.                           at 0/1.
  317.  
  318.   volume <volume>         64 (maximal volume)
  319.                           Sets the volume to <volume>. Where volume can
  320.                           range from 0 to 64.
  321.                         
  322.   balance <balance>       0
  323.                           Sets the balance to <balance>. Where balance can
  324.                           range from -64 (left channels only) to 64 (right
  325.                           channels only).
  326.  
  327.   reqlines <lines>        0 (requester internal default setting).
  328.                           Specifies the filerequester height in lines.
  329.  
  330.   subsong <number>        0 (first subsong)
  331.                           Sets the subsong counter to <number> if the
  332.                           player for the first module in the soundlist
  333.                           supports subsongs.
  334.  
  335.   playing <yes|no>        yes (first module is playing)
  336.                           Defines if the first module in the soundlist
  337.                           should be loaded, when DeliTracker is started.
  338.  
  339.   filter <yes|no>         no (filter off)
  340.                           Switches the internal lowpass filter on or off.
  341.                           An advantage of having the filter off is that
  342.                           frequencies over 7kHz are not cut off. This has
  343.                           the effect that most modules will sound much
  344.                           better.
  345.                           Note: On A1000 this switch has no effect.
  346.  
  347.   quick <yes|no>          yes (module is played immediately after loading)
  348.                           Defines if a loaded module should begin to play
  349.                           immediately after loading or if the module is
  350.                           in a paused state. This option is meant for
  351.                           synchronization purposes in ARexx scripts.
  352.  
  353.   random <yes|no>         no (sequential order)
  354.                           Lets you specify whether a Next/Prev-Song event
  355.                           should take a randomly picked or the following 
  356.                           (preceeding) list entry for loading. Once a 
  357.                           module has been played it won't be reselected 
  358.                           until other selected modules have been played.
  359.                           This behaviour is also known as 'Shuffleplay'.
  360.                           This option only works if there are more than 2 
  361.                           entries in the modulelist.
  362.  
  363.   append <yes|no>         no (replace modulelist with new selection)
  364.                           Lets you specify whether the soundlist should be
  365.                           appended at the end or replaced by the current
  366.                           selection. If this option is set, multiselect of
  367.                           modules from different directories is possible.
  368.  
  369.   fadeout <yes|no>        no (don't fade)
  370.                           Lets you specify whether the song should be faded
  371.                           out on a eject event or if no smooth transition 
  372.                           should be done. This feature is only available 
  373.                           for players that support volume changing.
  374.  
  375.   songend <yes|no>        no (ignore songend signals)
  376.                           Lets you specify whether songend events should
  377.                           be ignored or not. SOME players support a
  378.                           notification of the song end. If this option is
  379.                           set, DeliTracker will pause the module and load 
  380.                           the next module in the list. If only one module
  381.                           is in the soundlist then it is paused after the
  382.                           song has played once.
  383.  
  384.   timeout <secs>          0 (no timeout)
  385.                           Lets you specify the amount of time (in secs)
  386.                           after that DeliTracker will cause a Next-Song
  387.                           event. A value of 0 disables timeout. 
  388.  
  389.  
  390.   5.5 Configuration files
  391.  
  392.   A Configuration file contains one or more options with the appropriate
  393.   arguments. The only option that is not possible is the 'config' option.
  394.   Only one option per line is allowed. DeliTracker can create configfiles
  395.   with the save functions from the prefs window. Another way is to create 
  396.   a config file by your own with an editor or automatically by using the 
  397.   following NewList alias: 'alias ModList NL -hTigfsF "module=\'%P\'" []'.
  398.   Only redirect the output to a file.
  399.  
  400.   Example of a configfile:
  401.  
  402.   windowxy=473/15
  403.   random=yes
  404.   songend=yes
  405.   timeout=300
  406.   reqlines=50
  407.   subsong=2
  408.   playerpath="Data:DeliPlayers"
  409.   module="Data:Modules/SonicArranger/MF__Slowmotion1.3.pp"
  410.   module="Data:Modules/FutureComposer13/hidden part.pp"
  411.  
  412.   Tooltypes and CLI options have a higher priority over the options in a
  413.   configfile. This means they can override config file settings.
  414.  
  415.   At startup DeliTracker tries to open 'ENV:DeliTracker.config' as the
  416.   default configfile. If this file can be opened, DeliTracker uses all
  417.   settings that are contained therein. After this DeliTracker loads the
  418.   external players and plays the first module. If the Configfile is not
  419.   present, DeliTracker tries to load all external players that are located
  420.   in the 'Deliplayers' directory on the current path.
  421.  
  422.  
  423. 6. HOW TO CONTROL DELITRACKER
  424.  
  425.   6.1 The main window
  426.   
  427.   The main window is the central part of the DeliTracker. All module
  428.   specific things may be controlled with this panel.
  429.  
  430.     6.1.1 Gadgets
  431.     
  432.     This is a overview of the functions of the gadgets. If a gadget is
  433.     drawn ghosted then this option is not accessible for this player.
  434.     Two reasons why this is so: First, the soundsystem does not have this
  435.     feature at all (e.g. SoundTracker has no SubSongs), or second, the 
  436.     player is not perfectly adapted (which is more likely).
  437.  
  438.  
  439.     +---------+-+------------------------------------------------+-+
  440.     |         | |                                             [] | | [15]
  441. [1] |    ?    + +------------------------------------------------+ +
  442.     |         | |                            []                  | | [14]
  443.     +---+-----+-+--+-----+-----+-----+----+-----+-----+-----+----+-+
  444. [2] | + |     |    |     |     |     |    |     |     |     | |¯¯\ |
  445.     +---+  |< |  < |  << |  |> |  >> |  > |  >| |  [] |  ^  | |  | |
  446. [3] | - |     |    |     |     |     |    |     |     |  -  | +--+ |
  447.     +---+-----+----+-----+-----+-----+----+-----+-----+-----+------+
  448.           [4]   [5]  [6]   [7]   [8]   [9]  [10]  [11]  [12]  [13]
  449.  
  450.      [1] opens or closes the Prefs-Window
  451.  
  452.      [2] Faster: plays song a little faster
  453.  
  454.      [3] Slower: plays song a little slower
  455.  
  456.      [4] Prev Song: play the previous song. This gadget is only enabled if
  457.          more than one file was selected. If Randomplay is selected this 
  458.          button picks a random module. See also Randomplay.
  459.  
  460.      [5] Prev Pattern: Jumps to the previous pattern. If the current 
  461.          pattern is the first, the counter is set to the last pattern.
  462.  
  463.      [6] Prev SubSong: Jumps to the previous sub-song (if available).
  464.  
  465.      [7] Play/Pause: Plays a paused sound or pauses a playing sound.
  466.  
  467.      [8] Forward: Jumps to the next pattern in the module. If the current
  468.          pattern is the last, the counter is set to the first pattern.
  469.  
  470.      [9] Next Song: This button loads the next module form the selected
  471.          Soundlist. If the last module of the list is playing and you 
  472.          press this button the first module of the list will be played
  473.          (cyclic list). If Randomplay is selected this button has the same
  474.          function as the Prev Song button.
  475.  
  476.     [10] Next SubSong: Plays the next SubSong of a module. This function
  477.          allows you to select other melodies in the module. Not every
  478.          Soundsystem provides you this feature. One of the most common
  479.          Soundsystems that provide multi-modules is TFMX.
  480.  
  481.     [11] Stop Song: This button resets the patterncounter and the speed to
  482.          the initial default value.
  483.  
  484.     [12] Kill Song: stops the actual module and removes it from memory.
  485.  
  486.     [13] Load Song: Opens the filerequester and lets you select one or
  487.          more modules for playing. The first selected module is loaded
  488.          and played. If enough memory is available, DeliTracker will use 
  489.          double buffering. This means that the actual song continues
  490.          playing until the next song is loaded.
  491.  
  492.     [14] Balance Control: Let you change the Volume.
  493.  
  494.     [15] Volume Control: Let you change the Balance
  495.  
  496.  
  497.     6.1.2 Menus
  498.            Project
  499.                 Load Module <A> L .........Open the filerequester.
  500.                 Play/Pause        .........Play or pause a module.
  501.                 Stop Playing      .........Stopt the actual module.
  502.                 Eject Module      .........Stop playing and remove the
  503.                                            actual module from memory.
  504.                 ================= 
  505.                 Prefs ...         .........Open prefs window
  506.                 =================
  507.                 About ...   <A> ? .........Open 'About' requester.
  508.                 =================
  509.                 Quit        <A> Q .........Quit DeliTracker.
  510.  
  511.            Control      
  512.                 Faster            .........Increase Playspeed.
  513.                 Slower            .........Decrease Playspeed.
  514.                 Forward           .........Jump one Pattern forward.
  515.                 Backward          .........Jump one Pattern back.
  516.                 Next SubSong      .........Play next Subsong.
  517.                 Prev Subsong      .........Play previous Subsong.
  518.                 Next Module       .........Load the next module in the
  519.                                            Soundlist. See also Randomplay.
  520.                 Prev Module       .........Load previous module.
  521.  
  522.  
  523.     6.1.3 Shortcuts
  524.  
  525.     All functions of the mainwindow can although be reached with shortcuts.
  526.     To make them easy to remember we decided to order them hirarchically on
  527.     the nummeric keypad. In additon you may specify a HotKey for opening
  528.     and closing of the mainwindow (refer to cx_hotkey).
  529.  
  530.     * and <A> L open the filerequester for moduleselection.
  531.     /           open or close the prefs window.
  532.  
  533.     ] and )     play next song in the modulelist
  534.                 (only if more files are selected).
  535.     [ and (     play previous song (same as above).
  536.  
  537.     8           play next subsong.
  538.     7           play previous subsong.
  539.  
  540.     5           step to next pattern.
  541.     6           skip one pattern back.
  542.  
  543.     +           increase playspeed.
  544.     -           decrese playspeed.
  545.  
  546.     1           stop song (stop playing, reset patterncunter).
  547.     0           play/pause (toggles between playing and paused).
  548.  
  549.     .           stop song and remove it from memory (eject).
  550.  
  551.     9           decreases the volume (besides -).
  552.     6           increases the volume (besides +).
  553.  
  554.     2           changes the balance
  555.                 (decreases the volume of the right channels).
  556.     3           changes the balance.
  557.                 (increases the volume of the right channels)
  558.  
  559.     <A> ?       opens the 'About' requester.
  560.     <A> Q       quits DeliTracker.
  561.  
  562.   6.2 The preferences window
  563.  
  564.   The preferences window is for seting all global and player specific
  565.   options. To open the prefs window you may either select the 'Prefs ...'
  566.   menu or the '?'-Gadget of the mainwindow. Of course, there is a short 
  567.   cut ('/') and an arexx-command ('openprefswin'), too. To activate a
  568.   player select it from the player requester. After selecting a player,
  569.   all informations about the player is shown beside it in the player
  570.   information field.
  571.  
  572.     6.2.1 Gadgets
  573.  
  574.     ADD          Load an external player and set the playerpath.
  575.                  If a player with the same name is already loaded,
  576.                  the player with the lower version number will be
  577.                  expunged.
  578.  
  579.     DEL          Deletes the selected player. This means the player is
  580.                  unloaded. Internal players may be deleted too, but the
  581.                  memory is not freed.
  582.  
  583.     Filter       Refer to 5.4 filter option.
  584.  
  585.     Quick        Refer to 5.4 quick option.
  586.  
  587.     Random       Refer to 5.4 random option.
  588.  
  589.     Songend      Refer to 5.4 songend option.
  590.  
  591.     Append       Refer to 5.4 append option.
  592.  
  593.     Fadeout      Refer to 5.4 fadeout option.
  594.  
  595.     Time         Refer to 5.4 timeout option.
  596.  
  597.     Load Config  Load a saved configuration and set all values.
  598.  
  599.     Save Config  Save all actual settings and the current module list
  600.                  to a configuration file.
  601.  
  602.     Save List    Only save the module list to a configuration file.
  603.  
  604.     Config       If the player provides a player specific configuration
  605.                  routine this routine will be called.
  606.  
  607.     OK           Close the preferences window.
  608.  
  609.  
  610.     You can set the playerdirectory by typing the path into the stringgad
  611.     (on the lefthand of the ADD gadget) or using the filerequester (ADD).
  612.  
  613.     6.2.2 Shortcuts
  614.  
  615.     To make the shortcuts easy to remember we decided to use the first
  616.     letter of the function (if not already used) as shortcuts. Shortcuts
  617.     may be entered either in lower or upper case.
  618.  
  619.     a           <A>dd (Filerequester for loading players).
  620.  
  621.     d           <D>el (delete selected player).
  622.  
  623.     l           <L>oad (Load a config file).
  624.  
  625.     s           <S>ave (Save a config file).
  626.  
  627.     c           <C>onfig (configure selected player).
  628.  
  629.     o           <O>k (Close preference window).
  630.  
  631.     q           <Q>uick (toggle quick).
  632.  
  633.     f           <F>ilter (toggle filter).
  634.  
  635.     r           <R>andom (toggle random).
  636.  
  637.     p           A<P>pend (toggle append).
  638.  
  639.     e           Song<E>nd (toggle songend detection).
  640.  
  641.     u           Fadeo<U>t (toggle fadeout).
  642.  
  643.     t           <T>ime(out) (activate timeout gadget).
  644.  
  645.   6.3 ARexx 
  646.  
  647.   Nearly every function of DeliTracker may be controlled with ARexx.
  648.   This is very nice if you are using other ARexx aware software
  649.   like AmigaVision(TM). DeliTracker is addressed as a function host
  650.   with the name "rexx_DT". DeliTracker provides the following commands:
  651.  
  652.   quit                  Leave DeliTracker.
  653.  
  654.   filter <yes|no>       yes: Switch filter on.
  655.                         no:  Switch filter off.
  656.  
  657.   quickstart <yes|no>   yes: Turn quick on.
  658.                         no:  Turn quick off.
  659.  
  660.   random <yes|no>       yes: Turn Randomplay on.
  661.                         no:  Turn Randomplay off.
  662.  
  663.   songend <yes|no>      yes: Recognize songend signals.
  664.                         no:  Ignore songend events.
  665.  
  666.   append <yes|no>       yes: Activate append mode.
  667.                         no:  Deactivate Append mode.
  668.  
  669.   fadeout <yes|no>      yes: Activate fadeout mode.
  670.                         no:  Deactivate fadeout mode.
  671.  
  672.   timeout <SECS>        Set timeout to given number of seconds (SECS) 
  673.                         If SECS = 0 the timeout function is disabled.
  674.  
  675.   volume <VOL>          Set volume to <VOL> (Range VOL: 0 to 64).
  676.  
  677.   balance <BAL>         Set balance to <BAL>, 0 is default, -64 left only,
  678.                         64 right only (Range BAL: -64 to 64).
  679.  
  680.   forward               Play next pattern.
  681.  
  682.   backward              Play previous pattern.
  683.  
  684.   nextsong              Play next song (module).
  685.  
  686.   prevsong              Play previous song (module).
  687.  
  688.   nextsubsong           Play next subsong.
  689.  
  690.   prevsubsong           Play previous subsong.
  691.  
  692.   faster                Increase playspeed.
  693.  
  694.   slower                Decrease playspeed.
  695.  
  696.   loadconfig [FILE]     Load configfile [FILE] if [FILE] was specified,
  697.                         else pop filerequester up.
  698.  
  699.   saveconfig [FILE]     Save configfile [FILE] if [FILE] was specified,
  700.                         else pop filerequester up.
  701.  
  702.   savelist [FILE]       Save module list to [FILE] if [FILE] was specified,
  703.                         else pop filerequester up.
  704.  
  705.   loadplayer [PLAYER]   Load the [PLAYER] if specified, else open
  706.                         loadplayer requester.
  707.  
  708.   deleteplayer <NUMBER> Remove player number <NUMBER> from memory.
  709.                         Note: all modules of this player won't be
  710.                         recognized any longer.
  711.  
  712.   configplayer <NUMBER> Call the configuration routine of the 
  713.                         player <NUMBER>.
  714.  
  715.   playpause             Play/Pause song.
  716.  
  717.   stop                  Stop song.
  718.  
  719.   playmod [MODULE]      play [MODULE] if [MODULE] was specified else pop
  720.                         requester up.
  721.  
  722.   eject                 Remove active module from memory.
  723.  
  724.   pubscreen <SCREEN>    Closes all DeliTracker windows and tries to open
  725.                         the mainwindow on the pubscreen <SCREEN>. This
  726.                         function only exists in the 2.0 version.
  727.  
  728.   openmainwin           Open and/or activate mainwindow.
  729.  
  730.   closemainwin          Close mainwindow.
  731.  
  732.   openprefswin          Open and/or activate prefs window.
  733.  
  734.   closeprefswin         Close the prefs window.
  735.  
  736.   status <group> <dependent>  Returns the actual status. This funtion is
  737.                         divided into three different groups: global
  738.                         settings (g), player specific settings (p) and
  739.                         module dependent settings (m). Additional
  740.                         arguments are specified after the group.
  741.  
  742.   <group> =     g :     Global
  743.  
  744.         <dependent>  = <cmd>
  745.  
  746.                <cmd>            description             returnvalue
  747.  
  748.                 ver             DeliTracker version     number
  749.                 dir             playerdir               string
  750.                 num             players                 number
  751.                 led             filter                  <yes|no>
  752.                 qst             quickstart              <yes|no>
  753.                 rnd             random                  <yes|no>
  754.                 app             append                  <yes|no>
  755.                 fad             fadeout                 <yes|no>
  756.                 end             songend                 <yes|no>
  757.                 tim             timeout in seconds      number
  758.                 mwi             mainwindow closed/open  <yes|no>
  759.                 pwi             prefswindow closed/open <yes|no>
  760.                 vol             current volume          number
  761.                 bal             current balance         number
  762.                 ply             paused or playing       <yes|no>
  763.                 pub             prefered pubscreen      string
  764.  
  765.   <group> =     m :     Module
  766.  
  767.         <dependent>  =  <cmd>
  768.  
  769.                <cmd>            description             returnvalue
  770.  
  771.                 dir             moduledir               string
  772.                 fil             filename                string
  773.                 pnr             actual PlayerNr         number
  774.                 max             selected modules        number
  775.                 num             actual position in list number
  776.  
  777.  
  778.  
  779.   <group> =     p :     Player
  780.  
  781.         <dependent>  =  <playernum> <cmd>
  782.  
  783.                <cmd>            description             returnvalue
  784.  
  785.                 nam             name                    string
  786.                 cre             creator                 string
  787.                 ver             player version          number
  788.                 vol             volume                  <yes|no>
  789.                 bal             balance                 <yes|no>
  790.                 jmp             patternjump             <yes|no>
  791.                 spd             playspeed               <yes|no>
  792.                 sub             subsong                 <yes|no>
  793.                 cfg             config                  <yes|no>
  794.                 pck             packable                <yes|no>
  795.  
  796.  
  797.   Square brackets [...] mark arguments that may be omitted. Arguments in
  798.   angle brackets <...> must be supplied.
  799.  
  800.   Note: For almost any command example scripts are available. All commands
  801.   may be entered in lower and upper case.
  802.  
  803.  
  804. 7. TROUBLESHOOTING
  805.  
  806.   Preferences window can't be opened: Check the screen height. It must be
  807.   at least 190 Pixels + Barheight. The Barheigth depends on the screenfont
  808.   height. Try to use a smaller font (topaz 8).
  809.   
  810.   Some external players have trouble with >68010 or SuperHires; these
  811.   problems often can't be fixed. The cause of this lies in the coding style
  812.   (e.g. the player is part of the module and contains modulespecific
  813.   code/data) of these players. Many players are hitting at the basic
  814.   principles of programming on the Amiga. Such things as poking directly
  815.   into processor vectors or working with nullpointers are often seen. Don't
  816.   be astonished if enforcer hits occur. These hits are only from external
  817.   players and *not* from DeliTracker itself!!  Usually the playspeed of the
  818.   players are the same on PAL/NTSC machines, because a CIA, rather than
  819.   a VBlank IRQ is used. Since some players essentially need a VBlank
  820.   interrupt, these players have different playspeeds depending on the
  821.   selected video mode (PAL/NTSC/Productivity).
  822.  
  823.   Some players dont take notice of the VBR (on >68000) and write directly
  824.   to the interrupt vector table ($70 Vector/Audio-DMA-End). This may have
  825.   the effect that you won't hear anything when VBR is nonzero. Those
  826.   players are marked in the player documentation.
  827.  
  828.   For Modem users: All players that use the DeliTracker internal timer
  829.   Interrupt should now work well with serial transfers. Players that
  830.   generate their own timer interrupt will probably not(!). This is due
  831.   to the fact that instead of executing the actual playroutine in the
  832.   timer interrupt itself, we cause a SoftInt (so that the real routine
  833.   executes in a lower interrupt priority than the RFB interrupt).
  834.  
  835.  
  836. 8. THE FUTURE OF DELITRACKER
  837.  
  838.   The future of DeliTracker is leading to 2.0 (or higher;-)! This is the
  839.   last release that features a Kick 1.3 version. New external players will
  840.   stay compatible unless they don't ask for 2.0 or a higher DeliTracker
  841.   version. At the moment we are thinking of writing a xmusic.library. This
  842.   library will essentially be the same as DeliTracker and easily allow you
  843.   to integrate Sound into your own programs.
  844.  
  845.  
  846. 9. ACKNOWLEDGEMENTS
  847.  
  848. Our special thanks go to the following people:
  849.  
  850.   Our betatesters Stefan, Daniel, Börnie and Manfred for their
  851.   bugreports and ideas.
  852.  
  853.   Armin Sander (Oktalyzer) and Carsten Schlote (Sonic Arranger) for
  854.   creating DeliPlayers for their soundsystems.
  855.  
  856.   All on IRC #amiga (Internet Relay Chat)
  857.  
  858.   Markus Illenseer and Christian Rattei for the correction of the
  859.   german docs.
  860.  
  861.   Kevin Dackiw for the enhancement of the NoisePacker players and the
  862.   correction of the english doc files.
  863.   [Hope it is a little clearer...8-)  -- KD]
  864.  
  865.   U. Dominik Müller for XPK.
  866.  
  867.   Colin Fox and Bruce Dawson for the incredibile req.library.
  868.  
  869.   Eric Kennedy for TstApp.rexx.
  870.  
  871.   and all others, who have send replays, modules or registrations.
  872.  
  873.  
  874.  
  875.  
  876.